home *** CD-ROM | disk | FTP | other *** search
/ MACD 5 / MACD 5.bin / workbench / monitory / sfragmem / sfragmem.doc < prev    next >
Text File  |  1992-11-21  |  4KB  |  99 lines
  1.  
  2.                               SFragMem 1.01
  3.                               *************
  4.  
  5.                       Documentation by Thies Wellpott
  6.                       (excuse my bad English, please)
  7.  
  8.  
  9. 1. Copyright
  10. ************
  11.  
  12. SFragMem is FreeWare (c) 1992 Thies Wellpott. You may copy it for free
  13. provided that
  14.         - no profit is made with it
  15.         - SFragMem is not included with commercial software without
  16.           written agreement from the owner of the copyright
  17.         - SFragMem is distributed with this documentation file,
  18.           "SFragMem.doc" and both files are unmodified
  19.  
  20. The source code is for personal use only. It need not to be distributed
  21. along with the program, but if it is the whole source code must be kept
  22. with it (currently only "SFragMem.c").
  23.  
  24.  
  25. 1.1. Warrenty
  26. *************
  27.  
  28. YOU USE THIS PROGRAM COMPLETELY ON YOUR OWN RISK! If you destroy any file,
  29. your computer, your car or even the whole universe or any part of it while
  30. using it, do not blame me, it is not my fault!
  31.  
  32.  
  33. 2. Introduction
  34. ***************
  35.  
  36. SFragMem is a abbreviation for "Show fragmentation of memory". Because of
  37. the flexibility, dynamic and the great multi-tasking of the Amiga OS the
  38. memory gets fragmented. Imagine you start program 1 which will be loaded to
  39. the first available memory address, afterwards you start program 2 which
  40. will be loaded behind program 1 and then you quit program 1. It`s memory is
  41. freed and their is the fragmentation. It is not possible to move this free
  42. memory directly behind other free areas; running programs would asks the
  43. guru where their memory has gone!
  44.  
  45. This utility shows the fragmentation of the memory graphically. The whole
  46. memory is drawn as a block with free and used areas using different colors.
  47. Besides you may get some more information about the currently displayed
  48. memory block like block size, total used and total free space and some
  49. internal datas.
  50.  
  51.  
  52. 3. Usage
  53. ********
  54.  
  55. SFragMem is runnable from the Workbench and from CLI/Shell but requires OS
  56. 2.0 (sorry 1.2/1.3 users, but it is really worth upgrading!). A window
  57. opens and displays the memory block with the highest priority (should be
  58. your fast memory). Used areas are drawn with color 3 (blue) and free areas
  59. are white (color 2). At the left side of the window there are a few marks
  60. that show you where you approx. can find specific memory addresses.
  61.  
  62. You may resize the window, the display then adjusts itself to the new size,
  63. try it! It is possible that the window size will change automatically if
  64. you release the sizing gadget. Each pixel corresponds 8 bytes (or a
  65. manifold of 8 bytes) of the memory. Following this rule, the memory block
  66. cannot fit every box, so the box is shrunken to the next smaller size.
  67. Then the window size is adjusted to this box size, you understand?
  68.  
  69. Press the right mouse button and you will see a pull down menu (ever sawn
  70. before? :-) ). "About" tells you some program information, "Quit" quits.
  71. "Next" in the "Memory" menu chooses the next memory block. Mostly their are
  72. two of them (fast memory and chip memory), but perhaps you have just one or
  73. a few more, depends on your hardware configuration. Choose "Next" a few
  74. times more until you completed the whole "circle". "Refresh" refreshes the
  75. display. If you start a program while SFragMem is running the display is
  76. not up to date. You solve this problem with "Refresh".
  77.  
  78. "Information" opens another window and displays some information about the
  79. current memory block. The main window is locked, it accepts no input.
  80. Activate it and you will (hopefully) see the busy pointer. The first line
  81. shows you the colors used for free and used areas. The second line of text
  82. says how many bytes one pixel displays (if halve of the bytes are free, the
  83. pixel is drawn with color 2, marked as free). The next lines are
  84. self-explaining, I hope (Lower, Upper and Attributes are internal). Close
  85. the information window to continue working with SFragMem.
  86.  
  87.  
  88. Bug reports, donations, ideas and nice programs are always welcome but not
  89. neccessary. My address:
  90.  
  91.         Thies Wellpott
  92.         Moorhauser Weg 14
  93.         2948 Schortens 1
  94.  
  95.         Germany
  96.  
  97.         (sorry, no e-mail)
  98.  
  99.